home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / prog / dwdoor23 / dwdfuncs.doc < prev    next >
Encoding:
Text File  |  1993-08-24  |  9.9 KB  |  155 lines

  1. DWDoor Functions and Subroutines Quick Reference
  2. ------------------------------------------------
  3.  
  4. Procedure Name                Typ  Description
  5. --------------                ---  -----------
  6. Ansi%                         VAR  -1 if ANSI allowed, 0 if not.
  7. AnsiColor$(Atr%)              FUN  Returns an ANSI command for changing colors
  8. AnsiLocate$(Row%,Col%)        FUN  Returns an ANSI command for locating the
  9.                                    cursor
  10. Attr%(forg%, bak%)            FUN  Returns an integer attribute of foreground
  11.                                    and background colors
  12. BBS$                          VAR  The BBS name.
  13. Back%                         VAR  Current background color.
  14. Baud&                         VAR  The baud rate of ComPort%.
  15. Beeper&                       VAR  Milliseconds before beep for no input
  16. CLR                           SUB  Clears the local and user screen
  17. CR$                           VAR  Carridge return CHR$(13)
  18. CRLF$                         VAR  Return + Linefeed CHR$(13)+CHR$(10)
  19. Carrier%(Comm%)               FUN  Tests to see if a carrier is present.
  20. Center$(Lin$,Columns%)        FUN  Returns a string centered in a string of
  21.                                    spaces
  22. CheckTime                     SUB  Checks the time in the program and exits if
  23.                                    exceeded
  24. ComInit$                      VAR  Complete string for opening com port.
  25. ComParity%                    VAR  The parity of ComPort%.
  26. ComPort%                      VAR  The comport number (1-8).
  27. Comm%                         VAR  OPENed COM port number.
  28. CommKey$                      FUN  Same as INKEY$ only checks the current
  29.                                    opened com port as well as the keyboard for
  30.                                    input.  Also does time checking.
  31. DCSRLIN%                      FUN  Gets the current cursor row position.
  32.                                    DesqView aware.
  33. DPos%                         FUN  Gets the current cursor col position.
  34.                                    DesqView aware.
  35. DPrint(Text$)                 SUB  Prints text on the screen at current cursor
  36.                                    position.
  37. DVGivUp                       SUB  Gives up a time slice of the active DesqView
  38.                                    window.
  39. DVPrint(Row%,Col%,Text$,Atr%) SUB  Prints text on the screen in active DesqView
  40.                                    window.
  41. DataLen%(Comm%)               FUN  Gets the Data length of the current opened
  42.                                    com port (1-8)
  43. DoorHelp$                     VAR  The filename displayed when ? used on the
  44.                                    command line.
  45. DoorInfo$(Path$)              FUN  Gets user and comport information from the
  46.                                    filename specified in Path$
  47. DoorInit(Path$)               SUB  Sets up variable defaults and constants as
  48.                                    well as reads the .CFG file and gets
  49.                                    information from it. If Path$="NONE" then
  50.                                    it will not prompt for any info from the
  51.                                    user, just gets all info from the door
  52.                                    file, and from the .CFG
  53. DoorName$                     VAR  Full Name of door.
  54. ErrLevel%                     FUN  Returns the ERRORLEVEL of a child process
  55.                                    shell.
  56. ErrorFile$                    VAR  The filename to write errors to.
  57. Exist%(File$)                 FUN  Tests to see if File$ exists in the path
  58.                                    specified.
  59. ExitDoor(Typ%)                SUB  Closes all files and ends the program.
  60. Extra$                        VAR  Extra string of 70 characters or less (opt).
  61. False%                        VAR  Constant 0
  62. FirstName$                    VAR  User's First Name.
  63. Fore%                         VAR  Current foreground color.
  64. GetBaud&(Comm%)               FUN  Gets the baud rate of the current opened
  65.                                    comport (1-8)
  66. GetExtra$(Search$)            FUN  Retrieves extra CFG variables
  67. GetLocalInfo                  SUB  If in LOCAL mode, this routine will ask for
  68.                                    questions and set up various defaults.
  69. Help(Fil$)                    SUB  Loads help information contained in Fil$ if
  70.                                    ? is used on the command line and asks if
  71.                                    user would like to enter LOCAL mode.  Also
  72.                                    pauses every 23 lines while displaying.
  73.                                    This file is not displayed to remote, only
  74.                                    locally.
  75. InComm$(Atr%,Agln%,NoRet%,    FUN  Gets input from the keyboard or comport if
  76.         Deflt$,DefHlt%,            active.
  77.         Choice$,Prompt$)           Atr%    = Color attribute to print prompt.
  78.                                    Agln%   = Length of input to accept.
  79.                                              If 0 then word-wrapping enabled,
  80.                                                input is displayed, no return
  81.                                                required, CRLF is issued.
  82.                                              If negative then input is not
  83.                                                displayed when entered.
  84.                                              If positive then input is
  85.                                                displayed when entered.
  86.                                    NoRet%  = If 0 then a return is required to
  87.                                                end input.
  88.                                              If negative, No return
  89.                                                is required.
  90.                                              If positive, No return is
  91.                                                required, a CRLF is issued.
  92.                                    Deflt$  = Default for no input, or 1
  93.                                              character for hidden text.
  94.                                    InHlt%  = Color attribute for displaying
  95.                                              input.
  96.                                    Choice$ = Allowed input, if blank then any
  97.                                              legal ASCII character is
  98.                                              accepted.
  99.                                    Prompt$ = Prompt to print before getting
  100.                                              input.
  101. InText$                       VAR  Extra input from the user
  102. IRQ$                          VAR  User's IRQ number (from 2 to 15) "" if not
  103.                                    used.
  104. KBLocal%                      VAR  -1 if LOCAL, 0 if at REMOTE.
  105. KBTime&                       VAR  KB time-out limit in seconds.
  106. LBack$                        VAR  CHR$(29)
  107. LBackSp$                      VAR  Local Backspace
  108. LastName$                     VAR  User's Last Name.
  109. Line25                        SUB  Prints status on lines 24 and 25
  110. MaxTime&                      VAR  Maximum amount of time in door allowed in
  111.                                    secs.
  112. More%                         FUN  Prompts for input from user if he wishes
  113.                                    more information.
  114.                                    Returns -1 if Yes
  115.                                             0 if No
  116.                                             1 if Continous
  117. NormalColor$                  VAR  Resets ANSI color to White on Black
  118. Okay%                         VAR  -1 if serial code matches, 0 if not
  119. OutComm(Atr%,LineFeed%,Text$) SUB  Prints a string out to the screen and
  120.                                    comport if active.
  121.                                      Atr%      = color attribute
  122.                                      LineFeed% = adds a linefeed if non-zero
  123.                                                  to string printed
  124.                                      Text$     = String to print
  125. PAUSE                         SUB  Prompts user to press a key to continue
  126. Parity%(Comm%)                FUN  Gets the parity of the opened com port (1-8)
  127. Parm$(Main$,Search$)          FUN  Parses string to any specified character(s)
  128. PrintFile(Tmp%,Fl$)           SUB  Prints an entire file to user with MORE
  129.                                    prompting. If Tmp% is a non-zero number,
  130.                                    then the screen is cleared before
  131.                                    displaying the file.
  132. RBack$                        VAR  CHR$(8)
  133. RBackSp$                      VAR  Remote Backspace
  134. Script(Func$,InStr$,OutStr$)  SUB  Use any of the commands in this lib
  135.                                    textually.
  136. Scrn2Str$(X1%,Y1%,X2%,Y2%)    FUN  Allows you to capture a portion of the
  137.                                    screen in ANSI.
  138. Serial$                       VAR  Returned from SERIAL variable in .CFG
  139. StopBits%(Comm%)              FUN  Gets the Stop Bits of the current opened
  140.                                    comport. (1-8)
  141. SysopF$                       VAR  The Sysop's First name.
  142. SysopL$                       VAR  The Sysop's Last name.
  143. SysopName$                    VAR  The full sysop's name (All Uppercase).
  144. TestComm                      SUB  Tests to see if a carrier is present if
  145.                                    door activated in remote mode.  Writes to
  146.                                    DWDOOR.ERR if carrier has been dropped.
  147. TimeIn&                       VAR  Time user started program in seconds.
  148. TimeLeft&                     VAR  Total time left in door in seconds.
  149. Trim$(T$)                     FUN  Trims a string on both ends
  150. True%                         VAR  Constant -1
  151. UserName$                     VAR  User's Full Name (All Uppercase).
  152. WriteDoorERR(TypERR%,Tmp$)    SUB  Creates a file called DWDOOR.ERR that will
  153.                                    contain the error information and brief
  154.                                    explaination of how to correct it.
  155.